home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / XmStringNConcat.z / XmStringNConcat
Encoding:
Text File  |  2002-10-03  |  3.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCoooonnnnccccaaaatttt((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCoooonnnnccccaaaatttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCoooonnnnccccaaaatttt - A compound string function that appends a
  10.           specified number of bytes to a compound string
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////XXXXmmmm....hhhh>>>>
  14.  
  15.           XXXXmmmmSSSSttttrrrriiiinnnngggg XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCoooonnnnccccaaaatttt ((((_s_1, _s_2, _n_u_m__b_y_t_e_s))))
  16.                XXXXmmmmSSSSttttrrrriiiinnnngggg  _s_1;;;;
  17.                XXXXmmmmSSSSttttrrrriiiinnnngggg  _s_2;;;;
  18.                iiiinnnntttt       _n_u_m__b_y_t_e_s;;;;
  19.  
  20.  
  21.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  22.           This page documents version 1.2 of the Motif library.
  23.  
  24.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.           XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCoooonnnnccccaaaatttt appends a specified number of bytes from _s_2
  26.           to the end of _s_1, including tags, directional indicators,
  27.           and separators.  It then returns the resulting compound
  28.           string.  The original strings are preserved.  The space for
  29.           the resulting compound string is allocated within the
  30.           function.  The application is responsible for managing the
  31.           allocated space.  The memory can be recovered by calling
  32.           XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee.
  33.  
  34.  
  35.           _s_1     Specifies the compound string to which a copy of _s_2
  36.                  is appended.
  37.  
  38.           _s_2     Specifies the compound string that is appended to the
  39.                  end of _s_1.
  40.  
  41.           _n_u_m__b_y_t_e_s
  42.                  Specifies the number of bytes of _s_2 to append to _s_1.
  43.                  If this value is less than the length of _s_2, as many
  44.                  bytes as possible, but possibly fewer than this
  45.                  value, will be appended to _s_1 such that the resulting
  46.                  string is still a valid compound string.
  47.  
  48.  
  49.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  50.           Returns a new compound string.
  51.  
  52.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  53.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee((((3333XXXX)))) and XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee((((3333XXXX)))).
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.